Monster Media 1996 #15

home *** CD-ROM | disk | FTP | other *** search

/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / renegade / rgv0513.zip / RGV.DOC < prev next >

Wrap

Text File | 1996-05-13 | 19KB | 434 lines

- The Renegade Verification System - ┌─────────── ┌────────── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─────────── ┌─── ┌────── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌─── ┌────── ┌─── ┌─── ┌────────── ┌──── - The Ultimate Renegade Verfication System - Written & Copyright (C) 1995 Gary Hall ┌──────────┐ │ CONTENTS └ Features Introduction Disclaimer Requirements Files INCLUDED in a valid archive of RGV Rengade Compatability Installation and configuration Important notes on validation levels The RGV-LOCK.DAT Running RGV Locally Other RGV Functions Registration How to reach the author Credits ┌──────────┐ │ FEATURES └ * Callback verification including extensions. * Multi-node (255 in theory). * DOS, Windows, & Os/2 aware. * Automatic lockout file cleanup. * Configurable ansi/ascii screens. * Internationally compatable. * Long distance time window settings. * Easy and SAFE validation for Renegade sysops. ┌──────────────┐ │ INTRODUCTION └ This program was written to fill the void of a decent automatic validation system for the Renegade bulletin board system (copyright by Cott Lang) using BP7. ┌────────────┐ │ DISCLAIMER └ RGV is supplied without any guarantees or warranties, expressed or implied, with regard to it's suitability or use for any purpose, other than contributing to the entropy of the universe. It does do that quite nicely, however. Like most people who create such trinkets, I created RGV to solve a particular problem of mine, on my system, with my setup, etc. I hope it works on yours, but if it breaks, you own both halves. ┌──────────────┐ │ REQUIREMENTS └ * MsDos v3+ or compatable OS. * Renegade v05-11 Exp. (for auto-validation to work). * A modem that displays verbal result codes. * 5 minutes. ┌──────────────────────────────────────────┐ │ FILES THAT SHOULD BE INCLUDED IN ARCHIVE └ README.1ST - Important. Read it. RGV.EXE - The main program. RGV.DOC - What you're reading right now you idiot. :) RGV-HIST.DOC - Quick rundown on additions/fixes/etc... BETASITE.NFO - Little info about beta-testing ChAoSoft programs. RGV will also read the following files if they exist in both .ASC & .ANS formats (they are displayed in order) : RGV1.* - opening screen display RGV2.* - number detection screen RGV3.* - displayed if area code is locked out RGV4.* - displayed if number is permenantly locked out RGV5.* - displayed if number is already used RGV6.* - displayed if RGV cannot call long distance because of time window or because it doesn't allow ld callbacks. RGV7.* - displayed if extensions are allowed RGV8.* - displayed if requiring passwords RGV9.* - displayed at hangup RGV10.* - displayed at callboot RGV11.* - displayed if RGV is set NOT to validate the user RGV12.* - displayed if callback is successful and caller is local RGV13.* - displayed if callback is successful and caller is long distance (* note : RGV hangs up on all LD calls to save you money *) If you're missing one or more of these files, download a copy from my BBS (see below). ┌────────────────────────┐ │ RENEGADE COMPATABILITY └ To take full advantage of RGV with your Renegade BBS, you MUST be running a valid copy of Renegade v05-11 Exp. (ie, the filesize of your RENEGADE.EXE will be exactly 86,784 bytes), RGV will still run, but it will only log the callback process. It will not attempt to read or write to anything no matter how you have it configured if the above requirement is not met. This way, if you upgrade Renegade and forgot to get your updated copy of RGV, RGV will not touch your users.dat, renegade.dat, nor any other *.dat. Instead, it will only log activity for manual validation. ┌───────────────────────────────────────┐ │ INSTALLATION AND CONFIGURATION OF RGV └ STEP 1. - Unarchive RGV into a specified directory. STEP 2. - **IMPORTANT! READ RENEGADE COMPATABILITY SECTION ABOVE! ** - STEP 3. - Type "RGV /SETUP" ┌──────────────────────────────────────────────────────────────────────────────┐ │ RGV v05-13ß - Copyright 1996 - ChAoSoft(tm) │ └──────────────────────────────────────────────────────────────────────────────┘ Record #1 of 1. [Node #1] Page 1 of 2. ┌──────────────────────────────────────────────────────────────────────────────┐ │ [A] "Registered To" Name : UNREGISTERED │ │ [B] Path To Renegade.Dat : [path to Renegade.Dat] │ │ [C] Display File Path : <current path> │ │ [D] Log Path\Filename : <current path>\RGV.LOG │ └──────────────────────────────────────────────────────────────────────────────┘ ┌────────────────────────────────────┐┌────────────────────────────────────────┐ │ RGV Configuration Information ││ [J] Node Reference : 1 │ └────────────────────────────────────┘│ [K] Callback Attempts : 3 │ ┌────────────────────────────────────┐│ [L] Password Attempts : 5 │ │ [E] Number In User Note : No ││ [M] Seconds Before Dialing : 7 │ │ [F] Lockout Prev. Numbers : No ││ [N] Seconds To Connect : 60 │ │ [G] Allow Long Distance : No ││ [O] Local Validation Level : B │ │ [H] Create Password : No ││ [P] LD Validation Level : D │ │ [I] Allow Extensions : No ││ [Q] INTL Dial Prefix : 1 │ └────────────────────────────────────┘└────────────────────────────────────────┘ Ins = Insert Entry ] = Forward Record PgUp = Next Page Del = Remove Entry [ = Backward Record Esc = Save/Exit A. Registered To" Name : [registered versions only] B. Path To Renegade.Dat : [drive:\+path to Renegade.Dat] C. Display File Path : [drive:\+path to RGV's *.ANS/*.ASC files] D. Log Path\Filename : [drive:\+path+\+filename of RGV's logfile] E. Number In User Note : Toggle whether or not RGV should write the phone number verfifed in the "User Note" field of your users.dat. F. Lockout Prev Numbers : Toggle whether or not you wish multiple calls to the same number, ie., multiple users in the same household (See "The RGV-LOCK.DAT" below). G. Allow Long Distance : Toggle whether or not you wish RGV to perform callbacks out of your areacode. RGV will hangup once successful validation is complete. (note : RGV does not do international callbacks). H. Create Password : RGV can create a unique password for each call just prior to initiating callback. This is *not* theh user's system password and will only be used during that particular callback. I. Allow Extensions : Allow the use of phone extension numbers, ie., those used in dorms and offices. If this is toggled "Yes", RGV will dial the phone number, add the modem delay string (provided by you below), then dial the extension number. J. Node Reference : What node number is the record relative to? [Max=255] K. Callback Attempts : How many times RGV will attempt to callback during a session. [Max=25] L. Password Attempts : How many times RGV will allow an incorrectly entered password before hanging up. [Max=25] M. Seconds Before Dialing : Number of seconds to wait after hanging up and initializing the modem before attempting callback. [Max=15] N. Seconds To Connect : Number of seconds to wait before RGV should give up on a callback attempt and go to the next or exit. [Max=180] O. Local Validation Level : Renegade subscription level "A-Z" to validate callbacks within your local calling area. P. LD Validation Level : Renegade subscription level "A-Z" to validate callbacks who are *not* in your local calling area and are not out of the US. Q. INTL Dial Prefix : What is your international dial prefix. (example : 1 = USA & CANADA) ┌─────────────────────────────────────────────┐ │ ** IMPORTANT ** Notes on validation levels. └ * Validation levels are the same as what you have configured in your Renegade system configuration (G. Subscription/Validation System). * If a validation level is blanked in RGV, RGV will not validate the user and display "RGV11.*". Otherwise the user will be validated to the specified Renegade subscription/validation level. * If a validation level is NOT blanked, Renegade version is incompatable, or RENEGADE.EXE is hex edited then RGV will not attempt to touch Renegade at all. It will only log the information about the callback. STEP 4. - Press the "Page Up" key and we have : ┌──────────────────────────────────────────────────────────────────────────────┐ │ RGV v05-13ß - Copyright 1996 - ChAoSoft(tm) │ └──────────────────────────────────────────────────────────────────────────────┘ Record #1 of 1. [Node #1] Page 2 of 2. ┌───────────────────────────────────┐┌─────────────────────────────────────────┐ │ [A] Init : ATE1Q0V1X4&C1&D2S0=30 ││ [J] Answer : ATA │ │ [B] Dial : ATDT ││ [K] Hangup : ATH0 │ └───────────────────────────────────┘│ [L] Connect : CONNECT │ ┌───────────────────────────────────┐│ [M] Ok : OK │ │ 0.....6.....0.....6..... ││ [N] Ring : RING │ │ [C] Sun:........................ ││ [O] Busy : BUSY │ │ [D] Mon:........................ ││ [P] No Dial Tone : NO DIAL TONE │ │ [E] Tue:........................ ││ [Q] No Carrier : NO CARRIER │ │ [F] Wed:........................ ││ [R] Error : ERROR │ │ [G] Thr:........................ ││ [S] Voice : VOICE │ │ [H] Fri:........................ ││ [T] Fax : FAX │ │ [I] Sat:........................ ││ [U] Delay : ,,,,,, │ └───────────────────────────────────┘└─────────────────────────────────────────┘ The following are a brief description of the above key options : Ins - (the insert key) - Creates another record for another node. Del - (the delete key) - Marks the current configuration for removal from "RGV.CFG" once you press ESC (see below). Pressing the "Del" key on a record marked for deletion will unmark it. ] - (the left bracket key) - if you have more than 1 node configured, pressing this will allow you to move forward to the next node config. [ - (the right bracket key) - same as above except this moves backwards. PgUp - (the page up key) - goes to the second page of options. Esc - (the escape key) - Quit & save. A. Initialization : Initialization string to use before calling B. Dial Command : Your dialing prefix C.- I. : Place an "X" in the time frame you allow LD callback verifications for each day of the week. J. Answer Command : Your modem answer command K. Hangup Command : Your modem hangup string L. Connect : Your modem's VERBAL connect response M. Ok : Your modem's VERBAL ok response N. Ring : Your modem's VERBAL ring response O. Busy : Your modem's VERBAL busy response P. No Dial Tone : Your modem's VERBAL no dial tone response Q. No Carrier : Your modem's VERBAL no carrier response R. Error : Your modem's VERBAL error response S. Voice : Your modem's VERBAL voice response T. Fax : Your modem's VERBAL fax response U. Modem Delay : Your modem's delay command string to use before dialing an extension. STEP 5. - Create the batch file to call RGV For a single node BBS, you can use: @Echo Off C:\ Cd\Rgv Rgv <Path to Door.Sys> ( ie., RGV C:\BBS\DROP ) For a multi-node BBS, you can try this: @Echo Off C:\ Cd\Rgv Rgv <Path to Door.Sys> ( ie.. RGV C:\BBS\DROP%1) The %1 in a multi-node setup passes the node variable. You may also add a "/H" to the end of the string to force RGV to hangup on all callbacks. ( ie., RGV C:\BBS\DROP /H ) STEP 6. - Run RGV /IMPORT. This will read your Renegade USERS.DAT file and create a standard text file of validated users, thier numbers, the date, and the time. Be sure to edit this to lockout 911, 1-800, etc... calls. (See "The RGV-LOCK.DAT" below). STEP 7. (optional) - Edit all .ASC, & .ANS files for your personal needs/likes/dislikes STEP 8. - Create an entry for RGV in your Renegade start menu. This is the menu you have defined in Renegade Config, Subscription Level A, Startout menu. NOTE!!! THIS DOOR ONLY READS DOOR.SYS! For a single node BBS use: ACS : !VV Cmdkeys : DG Options : R;RGV.BAT For a multi-node BBS use: ACS : !VV Cmdkeys : DG Options : R;RGV.BAT %N ┌──────────────────┐ │ The RGV-LOCK.DAT └ RGV-LOCK.DAT is your lockout file. This file keeps basic information about people who have completed successful callbacks with RGV like this : 1-219-744-0455 # NO EXT. # Gary Hall # 11/28/96 # 9:09 am ; You can permenantly lock out a number by adding a '+' before the entry thusly : +1-219-744-0455 # NO EXT. # Gary Hall # 11/28/96 # 9:09 am ; or permenantly lockout entire area codes like this : +1-900* # ; +1-800* # ; +1-000* # ; or use "X"'s to lockout 911 calls like this : +1-xxx-911* # ; the "xxx" field will lockout 911 calls to all areacodes. You MUST use this format (spaces and all) for RGV to function correctly. Also, if you allow RGV to use extensions, be aware, the user may still use a number located in RGV-LOCK.DAT if the extension is different. For convience sake, RGV will log dupicate numbers with different extensions in it's log file so by browsing your log file, you can see "funny things" when they happen. ;) ┌─────────────────────┐ │ Running RGV Locally └ RGV has no local switch because I didn't want to waste time and your hard drive space on too much redundant crap. But, if you want to get a look at it, you can run it locally from your bbs reading DOOR.SYS or edit a DOOR.SYS file and change the baud rate to "0". When in local mode, RGV will do everything it normally does save two things : 1) you can't see the automated call interruption routine. 2) it does NOT validate any account even if configured to do so. ┌─────────────────────┐ │ Other RGV Functions └ * Running RGV /CLEAN will read your Renegade USERS.DAT and compare the REAL NAMES of your users with what's in RGV-LOCK.DAT. If an entry exists for a user that is no longer in your system's user base, it will remove the entry from the RGV-LOCK.DAT. By using real names, you can change a user's handle and still utilize this feature. RGV /CLEAN will *NOT* remove entries in RGV-LOCK.DAT preceeded with a "+". * RGV /IMPORT will import all the users in your userbase that are NOT the same SL as your new user SL into RGV-LOCK.DAT. Very handy for those with large userbases. * RGV <path to door.sys> /H will countdown and hangup on all callbacks except international as they are never called back. * Yes, beating the ctrl-break keys should exit the program anywhere. Very handy when you hear that irrate person yelling through your modem speaker. :) ┌──────────────┐ │ Registration └ After being a sysop for 6 years, I know what kind of extreme cost can go into running a bulletin board if you actually register everything. Yet, at the same time, it took me a while to write this. So, I'm asking $5.00 (hell, I should get that for just typing out these docs :) ) for any continued use after 6 months. With your $5.00 you will recieve access to unlimited future registered versions and a clear conscience. Send all registrations to : Gary Hall 3504 Tillman Rd. Fort Wayne, IN 46816 ┌─────────────────────────┐ │ How to reach the author └ If you have a problem, I'm not home. :-) Just kidding. <grin> Internet - slammin@fwi.com Networks - Fidonet 1:236/64, ITCnet 85:30/0, ChaosNet 98:98/0, PODSnet 93:9607/0, & LibertyNet 76:19/69. BBS - The Pool Room (aka T.P.R. Systems) (219)447-7205 or (219)447-5698 ┌─────────┐ │ Credits └ Tanx fer Renegade Cott, Tim Strike (for the fossil routines and tips), & Don Cranford.